home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / tt / emcs1859.zoo / etc / emacs.man < prev    next >
Text File  |  1993-02-13  |  19KB  |  529 lines
  1.  
  2.  
  3.  
  4. EMACS(1)                                                 EMACS(1)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        emacs - GNU project Emacs
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        e✓em✓ma✓ac✓cs✓s [ _✓c_✓o_✓m_✓m_✓a_✓n_✓d_✓-_✓l_✓i_✓n_✓e _✓s_✓w_✓i_✓t_✓c_✓h_✓e_✓s ] [ _✓f_✓i_✓l_✓e _✓._✓._✓.  ]
  12.  
  13. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  14.        _✓G_✓N_✓U _✓E_✓m_✓a_✓c_✓s is a new version of _✓E_✓m_✓a_✓c_✓s_✓, written by the author
  15.        of the original (PDP-10)  _✓E_✓m_✓a_✓c_✓s_✓,  Richard  Stallman.   Its
  16.        user functionality encompasses everything other _✓E_✓m_✓a_✓c_✓s edi-
  17.        tors do, and it is easily  extensible  since  its  editing
  18.        commands are written in Lisp.
  19.  
  20.        _✓E_✓m_✓a_✓c_✓s  has an extensive interactive help facility, but the
  21.        facility assumes that you know  how  to  manipulate  _✓E_✓m_✓a_✓c_✓s
  22.        windows  and buffers.  CTRL-h (backspace or CTRL-h) enters
  23.        the Help facility.  Help Tutorial (CTRL-h t)  requests  an
  24.        interactive  tutorial which can teach beginners the funda-
  25.        mentals of _✓E_✓m_✓a_✓c_✓s in a few minutes.  Help  Apropos  (CTRL-h
  26.        a)  helps you find a command given its functionality, Help
  27.        Character (CTRL-h c) describes a given character's effect,
  28.        and  Help Function (CTRL-h f) describes a given Lisp func-
  29.        tion specified by name.
  30.  
  31.        _✓E_✓m_✓a_✓c_✓s_✓'_✓s Undo can undo several  steps  of  modification  to
  32.        your  buffers,  so it is easy to recover from editing mis-
  33.        takes.
  34.  
  35.        _✓G_✓N_✓U _✓E_✓m_✓a_✓c_✓s_✓'_✓s many  special  packages  handle  mail  reading
  36.        (RMail)  and  sending  (Mail),  outline editing (Outline),
  37.        compiling (Compile), running subshells within  _✓E_✓m_✓a_✓c_✓s  win-
  38.        dows  (Shell),  running a Lisp read-eval-print loop (Lisp-
  39.        Interaction-Mode), and automated psychotherapy (Doctor).
  40.  
  41.        There is an extensive reference manual, but users of other
  42.        Emacses should have little trouble adapting even without a
  43.        copy.  Users new to _✓E_✓m_✓a_✓c_✓s will be able to use  basic  fea-
  44.        tures  fairly  rapidly  by studying the tutorial and using
  45.        the self-documentation features.
  46.  
  47.        Emacs Options
  48.  
  49.        The following options are of general interest:
  50.  
  51.        _✓f_✓i_✓l_✓e    Edit _✓f_✓i_✓l_✓e_✓.
  52.  
  53.        +✓+_✓n_✓u_✓m_✓b_✓e_✓r Go to the line specified by _✓n_✓u_✓m_✓b_✓e_✓r (do not  insert
  54.                a space between the "+" sign and the number).
  55.  
  56.        -✓-q✓q      Do not load an init file.
  57.  
  58.        -✓-u✓u _✓u_✓s_✓e_✓r Load _✓u_✓s_✓e_✓r_✓'_✓s init file.
  59.  
  60.        -✓-t✓t _✓f_✓i_✓l_✓e Use  specified  _✓f_✓i_✓l_✓e  as  the  terminal instead of
  61.  
  62.  
  63.  
  64.                          1990 November 13                       1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. EMACS(1)                                                 EMACS(1)
  71.  
  72.  
  73.                using stdin/stdout.  This must be the first  argu-
  74.                ment specified in the command line.
  75.  
  76.        The following options are lisp-oriented (these options are
  77.        processed in the order encountered):
  78.  
  79.        -✓-f✓f _✓f_✓u_✓n_✓c_✓t_✓i_✓o_✓n
  80.                Execute the lisp function _✓f_✓u_✓n_✓c_✓t_✓i_✓o_✓n_✓.
  81.  
  82.        -✓-l✓l _✓f_✓i_✓l_✓e Load the lisp code in the file _✓f_✓i_✓l_✓e_✓.
  83.  
  84.        The following options are useful when running _✓E_✓m_✓a_✓c_✓s  as  a
  85.        batch editor:
  86.  
  87.        -✓-b✓ba✓at✓tc✓ch✓h _✓c_✓o_✓m_✓m_✓a_✓n_✓d_✓f_✓i_✓l_✓e
  88.                Edit  in  batch  mode  using the commands found in
  89.                _✓c_✓o_✓m_✓m_✓a_✓n_✓d_✓f_✓i_✓l_✓e_✓.  The editor  will  send  messages  to
  90.                stdout.   This  option  must  be  the first in the
  91.                argument list.
  92.  
  93.        -✓-k✓ki✓il✓ll✓l   Exit _✓E_✓m_✓a_✓c_✓s while in batch mode.
  94.  
  95.        Using Emacs with X
  96.  
  97.        _✓E_✓m_✓a_✓c_✓s has been tailored to work well  with  the  X  window
  98.        system.   If  you  run _✓E_✓m_✓a_✓c_✓s from under X windows, it will
  99.        create its own X window to display in.  You will  probably
  100.        want  to  start the editor as a background process so that
  101.        you can continue using your original window.
  102.  
  103.        _✓E_✓m_✓a_✓c_✓s can be started with the following X switches:
  104.  
  105.        -✓-r✓rn✓n _✓n_✓a_✓m_✓e
  106.                Specifies the program name which  should  be  used
  107.                when   looking   up   defaults  in  the  user's  X
  108.                resources.  This must be the first  option  speci-
  109.                fied in the command line.
  110.  
  111.        -✓-w✓wn✓n _✓n_✓a_✓m_✓e
  112.                Specifies the name which should be assigned to the
  113.                _✓E_✓m_✓a_✓c_✓s window.
  114.  
  115.        -✓-r✓r      Display the _✓E_✓m_✓a_✓c_✓s window in reverse video.
  116.  
  117.        -✓-i✓i      Use the "kitchen sink" bitmap icon when iconifying
  118.                the _✓E_✓m_✓a_✓c_✓s window.
  119.  
  120.        -✓-f✓fo✓on✓nt✓t _✓f_✓o_✓n_✓t_✓, -✓-f✓fn✓n _✓f_✓o_✓n_✓t
  121.                Set  the  _✓E_✓m_✓a_✓c_✓s window's font to that specified by
  122.                _✓f_✓o_✓n_✓t_✓.  You will find the various _✓X  fonts  in  the
  123.                _✓/_✓u_✓s_✓r_✓/_✓l_✓i_✓b_✓/_✓X_✓1_✓1_✓/_✓f_✓o_✓n_✓t_✓s  directory.   Note  that  _✓E_✓m_✓a_✓c_✓s
  124.                will only accept fixed width fonts.  Under the X11
  125.                Release  4  font-naming conventions, any font with
  126.                the value "m" or "c" in the eleventh field of  the
  127.  
  128.  
  129.  
  130.                          1990 November 13                       2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. EMACS(1)                                                 EMACS(1)
  137.  
  138.  
  139.                font  name  is  a  fixed width font.  Furthermore,
  140.                fonts whose name are of the form _✓w_✓i_✓d_✓t_✓hx_✓h_✓e_✓i_✓g_✓h_✓t  are
  141.                generally  fixed width, as is the font _✓f_✓i_✓x_✓e_✓d.  See
  142.                _✓x_✓l_✓s_✓f_✓o_✓n_✓t_✓s(1) for more information.
  143.  
  144.                When you specify a font, be sure to  put  a  space
  145.                between the switch and the font name.
  146.  
  147.        -✓-b✓b _✓p_✓i_✓x_✓e_✓l_✓s
  148.                Set  the _✓E_✓m_✓a_✓c_✓s window's border width to the number
  149.                of pixels specified by _✓p_✓i_✓x_✓e_✓l_✓s_✓.   Defaults  to  one
  150.                pixel on each side of the window.
  151.  
  152.        -✓-i✓ib✓b _✓p_✓i_✓x_✓e_✓l_✓s
  153.                Set the window's internal border width to the num-
  154.                ber of pixels specified by  _✓p_✓i_✓x_✓e_✓l_✓s_✓.   Defaults  to
  155.                one pixel of padding on each side of the window.
  156.  
  157.  
  158.        -✓-w✓w _✓g_✓e_✓o_✓m_✓e_✓t_✓r_✓y_✓, -✓-g✓ge✓eo✓om✓me✓et✓tr✓ry✓y _✓g_✓e_✓o_✓m_✓e_✓t_✓r_✓y
  159.                Set the _✓E_✓m_✓a_✓c_✓s window's width, height, and position
  160.                as specified.  The geometry  specification  is  in
  161.                the  standard X format; see _✓X(1) for more informa-
  162.                tion.  The width and height are specified in char-
  163.                acters; the default is 80 by 24.
  164.  
  165.  
  166.        -✓-f✓fg✓g _✓c_✓o_✓l_✓o_✓r
  167.                On color displays, sets the color of the text.
  168.  
  169.                See  the  file  _✓/_✓u_✓s_✓r_✓/_✓l_✓i_✓b_✓/_✓X_✓1_✓1_✓/_✓r_✓g_✓b_✓._✓t_✓x_✓t for a list of
  170.                valid color names.
  171.  
  172.        -✓-b✓bg✓g _✓c_✓o_✓l_✓o_✓r
  173.                On color displays, sets the color of the  window's
  174.                background.
  175.  
  176.        -✓-b✓bd✓d _✓c_✓o_✓l_✓o_✓r
  177.                On  color displays, sets the color of the window's
  178.                border.
  179.  
  180.        -✓-c✓cr✓r _✓c_✓o_✓l_✓o_✓r
  181.                On color displays, sets the color of the  window's
  182.                text cursor.
  183.  
  184.        -✓-m✓ms✓s _✓c_✓o_✓l_✓o_✓r
  185.                On  color displays, sets the color of the window's
  186.                mouse cursor.
  187.  
  188.        -✓-d✓d _✓d_✓i_✓s_✓p_✓l_✓a_✓y_✓n_✓a_✓m_✓e_✓, -✓-d✓di✓is✓sp✓pl✓la✓ay✓y _✓d_✓i_✓s_✓p_✓l_✓a_✓y_✓n_✓a_✓m_✓e
  189.                Create the _✓E_✓m_✓a_✓c_✓s window on the  display  specified
  190.                by  _✓d_✓i_✓s_✓p_✓l_✓a_✓y_✓n_✓a_✓m_✓e.   Must be the first option speci-
  191.                fied in the command line.
  192.  
  193.  
  194.  
  195.  
  196.                          1990 November 13                       3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. EMACS(1)                                                 EMACS(1)
  203.  
  204.  
  205.        -✓-n✓nw✓w     Tells _✓E_✓m_✓a_✓c_✓s not to use its special interface to X.
  206.                If you use this switch when invoking _✓E_✓m_✓a_✓c_✓s from an
  207.                _✓x_✓t_✓e_✓r_✓m(1) window, display is done in  that  window.
  208.                This  must  be  the  first option specified in the
  209.                command line.